home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / ss / readws13.zip / READ_WKS.DOC < prev    next >
Text File  |  1992-05-07  |  21KB  |  481 lines
  1.  
  2.  
  3.  
  4.                   Read_WKS, copyright 1991,92 Mountain Software
  5.  
  6.  
  7.  
  8.                                      Read_WKS
  9.                                  (Read Worksheet)
  10.  
  11.  
  12.  
  13.                    Data Extraction Utility for Lotus 123 files
  14.                                    Version 1.31
  15.                                    May 7, 1992
  16.  
  17.  
  18.  
  19.                                    _______
  20.                               ____|__     |               (R)
  21.                            --|       |    |-------------------
  22.                              |   ____|__  |  Association of
  23.                              |  |       |_|  Shareware
  24.                              |__|   o   |    Professionals
  25.                            -----|   |   |---------------------
  26.                                 |___|___|    MEMBER
  27.  
  28.  
  29.  
  30.  
  31.                           Autodesk Registered Developer
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.                                Jerry Workman, P.E. 
  41.                                1579 Nottingham Road
  42.                                Charleston, WV 25314
  43.                                   CIS 70717,3564
  44.                               Orders: 1-800-2424-PsL
  45.  
  46.  
  47.         Read_WKS Documentation                                     page 2
  48.         =================================================================
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                                 Table of Contents
  56.  
  57.  
  58.  
  59.         I.   U s i n g   R e a d _ W K S  . . . . . . . . . . . . . .   3
  60.              Purpose  . . . . . . . . . . . . . . . . . . . . . . . .   3
  61.              Installation . . . . . . . . . . . . . . . . . . . . . .   3
  62.              Running Read_WKS . . . . . . . . . . . . . . . . . . . .   3
  63.              Limits . . . . . . . . . . . . . . . . . . . . . . . . .   4
  64.              Uses and Suggestions . . . . . . . . . . . . . . . . . .   4
  65.  
  66.         II.  A d d e n d u m  . . . . . . . . . . . . . . . . . . . .   5
  67.              Error Messages . . . . . . . . . . . . . . . . . . . . .   5
  68.              Liability  . . . . . . . . . . . . . . . . . . . . . . .   6
  69.              Author . . . . . . . . . . . . . . . . . . . . . . . . .   6
  70.  
  71.         III. L i c e n s e  . . . . . . . . . . . . . . . . . . . . .   6
  72.              Registration Information . . . . . . . . . . . . . . . .   7
  73.              Definition of Shareware  . . . . . . . . . . . . . . . .   7
  74.              Disclaimer - Agreement . . . . . . . . . . . . . . . . .   8
  75.              Trademark  . . . . . . . . . . . . . . . . . . . . . . .   9
  76.  
  77.         IV.  I n d e x  . . . . . . . . . . . . . . . . . . . . . .    10
  78.  
  79.  
  80.         Read_WKS Documentation                                     page 3
  81.         =================================================================
  82.  
  83.  
  84.         I.   U s i n g   R e a d _ W K S
  85.         ================================
  86.  
  87.  
  88.         Purpose
  89.         -------
  90.  
  91.         Read_WKS is a very powerful program which is used to extract data
  92.         from Lotus  123 files. The  data can  be formatted in  CDF (comma
  93.         delimited) format, fixed format, and AutoCAD AutoLISP format, for
  94.         use by other programs, or  for reporting purposes. Read_WKS works
  95.         alone, it is not an add-in to Lotus nor does it  require a "print
  96.         to disk" from Lotus.
  97.  
  98.         Read_WKS reads  .WKS, WK1, and  WRK files directly (the  WK3 file
  99.         format is not supported at this time). The program reads not only
  100.         the data (values and labels)  from the spreadsheet file, but also
  101.         calculated formula values. Formatting information; Column widths,
  102.         cell  formats  (eg fixed,  comma,  $, etc),  and  cell alignments
  103.         (left, right, center),  are also read and can be  used in format-
  104.         ting the  extracted  data. Read_WKS  works on  IBM PC  compatible
  105.         computers running DOS 3.0 or higher with at least 120K  of avail-
  106.         able memory.
  107.  
  108.  
  109.         Installation
  110.         ------------
  111.  
  112.         READ_WKS.EXE can  be copied to any  directory that is  on the DOS
  113.         PATH and requires no special installation.
  114.  
  115.  
  116.         Running Read_WKS
  117.         ----------------
  118.  
  119.         Read_WKS  operated from the  DOS command line  using switches and
  120.         parameters to control  it's operations. The switches / commands /
  121.         functions are as follows:
  122.  
  123.         Usage: READ_WKS <switches> <filename>.WK1 <outfilename>
  124.  
  125.         The .WK1 extension is added to <filename> if omitted.
  126.         <outfilename> can also be CON, PRN, STDOUT or any DOS device.
  127.         Switches must start  with / or -  and are not case  sensitive but
  128.         must be placed before any file name(s).
  129.  
  130.         /D        Debug diagnostic display
  131.         /R___     Worksheet   Range   or  range   name[default   A1..D25]
  132.                   (eg /RB11..F35 or /RTOTALS),
  133.                   or "*" for the entire worksheet (/R*)
  134.         /A        AutoCAD  LISP   output  (default  output   filename  is
  135.                   ACAD.123)
  136.         /E        AppEnd output to the output file
  137.  
  138.  
  139.         Read_WKS Documentation                                     page 4
  140.         =================================================================
  141.  
  142.  
  143.         /I        Ignore repeating label cells (eg \=)
  144.         /U        Unformatted (maximum precision) output
  145.         /X        eXpanded formatted  report output, no  delimiter, fully
  146.                   formatted
  147.         /S_       Separator / Delimiter character(s) (eg /S;)
  148.         /Q        Quiet, no display except errors
  149.         /P        Password program - register Read_WKS
  150.         /H        Help - This message.
  151.  
  152.         Example: READ_WKS /RC19..F35 MYFILE MYFILE.PRN
  153.              Or: READ_WKS /A /R* MYFILE
  154.  
  155.  
  156.         Read_WKS  will  then  execute and  will  prompt  for  any missing
  157.         parameters:
  158.  
  159.         Enter worksheet filename:
  160.  
  161.              Enter     any      valid     DOS      filename     including
  162.              Drive:\path\filename.ext. If no file extension is  specified
  163.              then  ".WK1" is appended.  If you are reading  from a WKS or
  164.              WRK file then you must enter the full filename.
  165.  
  166.         Enter worksheet range, range name, "*" for all cells
  167.         or ? to list defined ranges[default A1..D25]:
  168.  
  169.              Enter  either   a  worksheet   range  in   the  usual   form
  170.              (eg BA34..CL63), or any range name defined in the worksheet.
  171.              You may enter a question mark "?" to list all range names in
  172.              the  selected  worksheet  file.  Enter  an asterisk  "*"  to
  173.              specify the entire worksheet.
  174.  
  175.  
  176.         Limits
  177.         ------
  178.  
  179.         Read_WKS can not read version 2.3, 3.X  Lotus, 123G or SQZ files.
  180.         If you use  a version of  Lotus 123 after  version 2.2 or a  dif-
  181.         ferent spreadsheet program (eg Quattro  or Excel) then save  your
  182.         file as  a .WK1 or .WKS  file, most spreadsheets  (and many other
  183.         programs) can save in these file formats.
  184.  
  185.         Read_WKS can not recalculate your spreadsheet.  If you use manual
  186.         recalculation then be sure to recalculate prior to saving so that
  187.         formula values will be correctly displayed.
  188.  
  189.  
  190.         Uses and Suggestions
  191.         --------------------
  192.  
  193.         You can  use your  favorite spreadsheet program  as a  data entry
  194.         form,  and later extract that data for  use in other programs, or
  195.         for consolidation using Read_WKS.
  196.  
  197.  
  198.         Read_WKS Documentation                                     page 5
  199.         =================================================================
  200.  
  201.  
  202.         You can use a simple batch file (see the file LOOP.BAT) to "loop"
  203.         through  a group  of files  (perhaps  all files  in a  directory)
  204.         extracting  a range  of values  from  each. Using  the /E  switch
  205.         Read_WKS will place all of this data  into a single file. You can
  206.         then "import" this  file containing  consolidated data from  many
  207.         (perhaps hundreds) of files into your spreadsheet or database.
  208.  
  209.         If you wish to use  Read_WKS with AutoCAD, an additional AutoLISP
  210.         program  (TAB123.LSP)  is  available   to  create  tables  within
  211.         AutoCAD. You  can obtain -=Tab123=-  from the ACAD forum  on Com-
  212.         puserve, many BBS's, or from Mountain Software directly.
  213.  
  214.  
  215.         II.  A d d e n d u m
  216.         ====================
  217.  
  218.         Error Messages
  219.         --------------
  220.  
  221.         Unidentified file format
  222.  
  223.              The file signature does not match a known file type.
  224.  
  225.         Cannot open file XXXX
  226.  
  227.              Reason: Misspelled filename or possible disk error.
  228.  
  229.         Unknown switch => X <=
  230.  
  231.              An  unknown   DOS  command   line  switch   was  passed   to
  232.              READ_WKS.EXE.
  233.  
  234.         Out of memory
  235.  
  236.              READ_WKS requires about 120K to run. 
  237.  
  238.         Unidentified Cell. OpCode = XXh Length = XX
  239.  
  240.              Usually caused by  processing a spreadsheet file  format not
  241.              known by READ_WKS.EXE.
  242.  
  243.         Unexpected end of input file
  244.  
  245.              The  end of  the file was  reached before  the end   of file
  246.              record was read.
  247.  
  248.         Error reading input file
  249.         Error writing to output file
  250.  
  251.              A disk error during a read or write operation occurred.
  252.  
  253.  
  254.         Read_WKS Documentation                                     page 6
  255.         =================================================================
  256.  
  257.  
  258.         Liability
  259.         ---------
  260.  
  261.         Careful  testing  has been  made  to ensure  that  these programs
  262.         perform  correctly. No  liabilities  are assumed  in  the use  or
  263.         misuse of this program  resulting in data  loss or damage. It  is
  264.         the  users responsibility  to be  sure  that the  results are  as
  265.         expected.
  266.  
  267.  
  268.         Author
  269.         ------
  270.  
  271.         If you have any suggestions or comments, please contact me.
  272.  
  273.         Jerry Workman, PE
  274.         1579 Nottingham Rd.
  275.         Charleston, WV 25314 
  276.         CIS 70717,3564
  277.         304-744-7748 (after 7:30PM ET)
  278.  
  279.         Copyright 1991,92 by Mountain Software All rights reserved 
  280.  
  281.  
  282.         III. L i c e n s e
  283.         ==================
  284.  
  285.  
  286.         Shareware
  287.         ---------
  288.  
  289.         This version of  Read_WKS is NOT public domain  or free software,
  290.         but is being  distributed as "shareware".  You may try it  out to
  291.         see  if it  is useful  for you.  If you  wish to continue  to use
  292.         Read_WKS you must register. Registered users are provided  with a
  293.         password to  remove the  opening delay and  with support  for one
  294.         year.
  295.  
  296.         The program in the form of the original archived file only may be
  297.         freely distributed, but not sold  (except under license, or for a
  298.         nominal copying or disk fee).
  299.  
  300.         Non-registered users of  this software are  granted a limited  30
  301.         day  license to  make an evaluation  copy for  trial use  for the
  302.         purpose of  determining whether  Read_WKS is  suitable for  their
  303.         needs. At the end of this  trial period, you may either  register
  304.         your copy, or discontinue using Read_WKS.
  305.  
  306.         All users are granted a limited license to copy Read_WKS only for
  307.         the trial  use of  others and subject  to the  above limitations.
  308.         This license  does NOT  include distribution  or copying  of this
  309.         software for use:
  310.  
  311.  
  312.         Read_WKS Documentation                                     page 7
  313.         =================================================================
  314.  
  315.  
  316.         1.   In connection with any other product or service.
  317.         2.   For general use within a company or institution.
  318.         3.   For distribution in modified form; i.e., the file containing
  319.              this license information  MUST be  included, along with  the
  320.              full Read_WKS documentation.
  321.  
  322.         Operators  of  electronic  bulletin board  systems  (Sysops)  are
  323.         encouraged to post Read_WKSxx.ZIP for downloading by their users,
  324.         as long as these conditions are met.
  325.  
  326.  
  327.         Registration Information
  328.         ------------------------
  329.  
  330.         A  Read_WKS registration  licenses you  to use  the product  on a
  331.         regular basis. Individual license cost for  Read_WKS is $30 which
  332.         includes a diskette  with the latest version of  Read_WKS and the
  333.         printed manual. West  Virginia residents should include  6% sales
  334.         tax. The  file ORDER.DOC  contains an  order form and  additional
  335.         ordering information.
  336.  
  337.         Educational institutions,  full-time students and  BBS sysops can
  338.         apply a 50% discount. PLEASE include your educational institution
  339.         letterhead (with your title), or  a photocopy of your most recent
  340.         registration slip, or the name and number of your BBS.
  341.  
  342.  
  343.         Definition of Shareware
  344.         -----------------------
  345.  
  346.         Shareware  distribution  gives  users a  chance  to  try software
  347.         before buying  it. If  you try a  Shareware program  and continue
  348.         using  it,  you  are expected  to  register.  Individual programs
  349.         differ  on  details  -- some  request  registration  while others
  350.         require  it,   some  specify   a  maximum   trial  period.   With
  351.         registration,  you get anything from the simple right to continue
  352.         using the software to an updated program with printed manual.
  353.  
  354.         Copyright laws apply  to both Shareware and  commercial software,
  355.         and the copyright holder retains  all rights, with a few specific
  356.         exceptions  as stated below.  Shareware authors  are accomplished
  357.         programmers, just like  commercial authors, and the  programs are
  358.         of comparable quality.  (In both cases,  there are good  programs
  359.         and  bad  ones!)  The  main   difference  is  in  the  method  of
  360.         distribution. The author  specifically grants  the right to  copy
  361.         and distribute  the software,  either to all  and sundry or  to a
  362.         specific group. For example, some authors require written permis-
  363.         sion before a commercial disk vendor may copy their Shareware.
  364.  
  365.         Shareware is a  distribution method, not a type  of software. You
  366.         should  find  software  that  suits  your needs  and  pocketbook,
  367.         whether it's commercial or Shareware.  The Shareware system makes
  368.         fitting your  needs easier, because  you can try before  you buy.
  369.  
  370.  
  371.         Read_WKS Documentation                                     page 8
  372.         =================================================================
  373.  
  374.  
  375.         And because the  overhead is low, prices are  low also. Shareware
  376.         has the  ultimate money-back  guarantee -- if  you don't  use the
  377.         product, you don't pay for it.
  378.  
  379.  
  380.         Disclaimer - Agreement
  381.         ----------------------
  382.  
  383.         Users  of  Read_WKS  must  accept  this disclaimer  of  warranty:
  384.         "Read_WKS is  supplied as is.   The author disclaims  all warran-
  385.         ties, expressed or  implied, including,  without limitation,  the
  386.         warranties of merchantability and of fitness for any purpose. The
  387.         author assumes no liability for damages, direct or consequential,
  388.         which may result from the use of Read_WKS."
  389.  
  390.         Read_WKS is a "shareware program" and is provided at no charge to
  391.         the  user  for  evaluation.   Feel  free to  share  it  with your
  392.         friends,  but please do  not give it  away altered or  as part of
  393.         another  system.  The essence  of "user-supported" software is to
  394.         provide personal  computer  users with  quality software  without
  395.         high prices,  and  yet to  provide incentive  for programmers  to
  396.         continue  to develop  new products.    If you  find this  program
  397.         useful and find that  you are using Read_WKS and  continue to use
  398.         Read_WKS  after  a  reasonable  trial period,  you  must  make  a
  399.         registration  payment  of  $30 to  Mountain  Software.   The  $30
  400.         registration fee will  license one copy for  use on any one  com-
  401.         puter at any one time.  You must  treat this software just like a
  402.         book.  An example is that this software may be used by any number
  403.         of people and may be  freely moved from one computer  location to
  404.         another, so  long as there is no possibility  of it being used at
  405.         one location  while it's being  used at  another. Just as  a book
  406.         cannot be read by two different persons at the same time.
  407.  
  408.         Commercial  users  of Read_WKS  must register  and pay  for their
  409.         copies of Read_WKS within 30 days  of first use or their  license
  410.         is withdrawn.   Site-License arrangements may be made  by contac-
  411.         ting Mountain Software.
  412.  
  413.         Anyone distributing Read_WKS  for any  kind of remuneration  must
  414.         first  contact  Mountain  Software  at   the  address  below  for
  415.         authorization. This  authorization will be  automatically granted
  416.         to  distributors  recognized by  the  (ASP)  as adhering  to  its
  417.         guidelines for shareware distributors, and such distributors  may
  418.         begin offering  Read_WKS immediately  (However Mountain  Software
  419.         must  still  be advised  so  that  the  distributor can  be  kept
  420.         up-to-date with the latest version of Read_WKS.).
  421.  
  422.         You  are  encouraged to  pass a  copy of  Read_WKS along  to your
  423.         friends for evaluation.  Please encourage them to register  their
  424.         copy if they find that they can use it. 
  425.  
  426.         Jerry Workman a  member of the  Association of Shareware  Profes-
  427.         sionals (ASP).  ASP wants to  make sure that the  shareware prin-
  428.  
  429.  
  430.         Read_WKS Documentation                                     page 9
  431.         =================================================================
  432.  
  433.  
  434.         ciple  works for you. If  you are unable  to resolve a shareware-
  435.         related  problem with  an  ASP member  by  contacting the  member
  436.         directly, ASP may be able to help. The ASP Ombudsman can help you
  437.         resolve a dispute  or problem with  an ASP  member, but does  not
  438.         provide technical support for members'  products. Please write to
  439.         the ASP Ombudsman at 545 Grover Road, Muskegon MI 49442, or  send
  440.         a message via Compuserve mail to ASP Ombudsman 70007,3536
  441.  
  442.  
  443.         Trademark
  444.         ---------
  445.  
  446.         Mountain  Software  and  Read_WKS  are  trademarks   of  Mountain
  447.         Software.  MS-DOS  is a  registered  trademark of  Microsoft Cor-
  448.         poration. PC-DOS is  a registered  trademark of IBM  Corporation.
  449.         AutoCAD is a registered  trademark of AutoDesk. 123  and Symphony
  450.         are registered trademarks of Lotus Development Corporation
  451.  
  452.  
  453.         Read_WKS Documentation                                    page 10
  454.         =================================================================
  455.  
  456.  
  457.         IV.  I n d e x
  458.  
  459.  
  460.              123 . . . . . . . . . . . . . . . . . . . .  1, 3, 4, 9
  461.              ACAD  . . . . . . . . . . . . . . . . . . . . . .  3, 5
  462.              ASP . . . . . . . . . . . . . . . . . . . . . . .  8, 9
  463.              AutoCAD . . . . . . . . . . . . . . . . . . . . 3, 5, 9
  464.              Command . . . . . . . . . . . . . . . . . . . . .  3, 5
  465.              Compuserve  . . . . . . . . . . . . . . . . . . .  5, 9
  466.              directory . . . . . . . . . . . . . . . . . . . .  3, 5
  467.              disk  . . . . . . . . . . . . . . . . . . . . .  3, 5-7
  468.              DOS . . . . . . . . . . . . . . . . . . . . . .  3-5, 9
  469.              error . . . . . . . . . . . . . . . . . . . . . . . . 5
  470.              file  . . . . . . . . . . . . . . . . . . . . . . . 3-7
  471.              filename  . . . . . . . . . . . . . . . . . . . . . 3-5
  472.              license . . . . . . . . . . . . . . . . . . . . . . 6-8
  473.              LISP  . . . . . . . . . . . . . . . . . . . . . . . . 3
  474.              Lotus . . . . . . . . . . . . . . . . . . .  1, 3, 4, 9
  475.              range . . . . . . . . . . . . . . . . . . . . . . . 3-5
  476.              range name  . . . . . . . . . . . . . . . . . . . . . 4
  477.              shareware . . . . . . . . . . . . . . . . . . .  1, 6-9
  478.              table . . . . . . . . . . . . . . . . . . . . . . . . 2
  479.              worksheet . . . . . . . . . . . . . . . . . . . 1, 3, 4
  480.              ZIP . . . . . . . . . . . . . . . . . . . . . . . . . 7
  481.